home *** CD-ROM | disk | FTP | other *** search
/ Hottest 6 / Hottest 6 (1996)(PDSoft)[!].iso / software / programming / c / turbotext / scmsg_rendezvous.doc < prev    next >
Encoding:
Text File  |  1978-11-24  |  2.6 KB  |  58 lines
  1.   NAME
  2.     scmsg_rendezvous.rexx - A rendezvous script for SCMSG and TTX - requires REXX
  3.  
  4.   FUNCTION
  5.     This simple rexx script functions as a rendezvous port between SAS/C's
  6.     (version 6.0 and up) SCMSG message browser utility and the TurboText
  7.     editor.  When SCMSG is used with one of the supplied configuration
  8.     files, SCMSG will send its messages to SCMSG_TTX_RENDEZVOUS message
  9.     port which scmsg_rendezvous has opened.  Scmsg_rendezvous interprets
  10.     and delivers the messages to the correct TTX window.
  11.  
  12.   REQUIREMENTS
  13.     - Arexx and Turbotext, of course
  14.     - AmigaOS 2.04 (need to modify the configuration file and/or rexx
  15.       script for use under earlier OS versions)
  16.     - rexxsupport.library
  17.     - rexxarplib.library (a small modification to the script is needed
  18.       to run without it)
  19.  
  20.   INSTALLATION
  21.     - copy scmsg_rendezvous.rexx to REXX:
  22.     - copy TTX_opts.scmsg (or TTX_opts.scmsg.wsh if you have WShell) to
  23.       ENV:sc/SCMSG and ENVARC:sc/SCMSG
  24.     That's it!  There's no need to run scmsg_rendezvous as SCMSG does
  25.     it for you if it cannot find the SCMSG_TTX_RENDEZVOUS message port
  26.     which the script is supposed to open.
  27.  
  28.   NOTES
  29.     - The documentation on SCMSG is not entirely correct (or complete).
  30.       For example, when SCMSG substitutes the filename for %f, it
  31.       currently seems to automatically enclose the filename in quotes
  32.       when needed (if the name contains a space).  This doesn't seem
  33.       to be documented anywhere, so the script might need modification
  34.       when a new SAS/C release comes out, as it relies on this feature.
  35.       Also, the %c template does not expand to the error column but to
  36.       the error class!
  37.     - Did you know that hitting ALT-CONTROL-HELP in SCMSG window
  38.       pops up an AmigaGuide on SAS/C error/warning messages?
  39.  
  40.   FILES
  41.     scmsg_rendezvous.rexx - the script (should be copied to REXX:)
  42.     TTX_opts.scmsg        - SCMSG configuration file (should be copied
  43.                             to ENVARC:sc/SCMSG)
  44.     TTX_opts.scmsg.wsh    - SCMSG configuration file for WShell 2.0
  45.                             owners (should be copied to ENVARC:sc/SCMSG)
  46.     scmsg_rendezvous.doc  - this documentation file
  47.  
  48.   BUGS
  49.     The SCMSG "altfile" command (alt-RETURN) does not work if the project's
  50.     "home directory" is different from that of the scmsg_rendezvous process.
  51.     This is actually a "feature" of the SCMSG utility as it doesn't return
  52.     the full filename of the alternate file.  An enhancement request has been
  53.     made through EMITS and a fix should appear in SAS/C version 6.3 (great
  54.     support, SAS folks!).
  55.  
  56.   AUTHOR
  57.     Kari Sutela, (Internet email: Kari.Sutela@utu.fi).
  58.